Markdown (y Rmarkdown)
Documentos sencillos, rápidos, y versátiles
Daniel Morillo
Universidad Autónoma de Madrid
10 de junio de 2021
Introducción a Markdown
¿Qué es Markdown?
Introducción a Markdown
Markdown es…
un lenguaje de marcado:
Texto
+
Marcas de formato
# Introducción a Markdown
**Markdown** es...
un _lenguaje de marcado_:
Texto
\+
Marcas de formato
Tiene “trampa”:
Animaciones, columnas
Introducción a Markdown
Markdown también es…
Pandoc
Permite convertir a:
¿Por qué usar Markdown?
Es muy legible:
# Título 1
## Título 2
**negrita** y _cursiva_
* puntos
* importantes
1. lista de
1. elementos
1. numerados
Título 1
Título 2
negrita y cursiva
lista de
elementos
numerados
¿Por qué usar Markdown?
Es muy legible:
### Título 3
#### Título 4
[enlace](https://www.ccomsuam.org/)
>Si buscas resultados distintos,
>no hagas siempre lo mismo.
--Albert Einstein
Título 3
Título 4
enlace
Si buscas resultados distintos, no hagas siempre lo mismo.
–Albert Einstein
¿Por qué usar Markdown?
Aunque permite insertar:
<center style='color:darkblue'>Estoy centrado y en azul</center>
Estoy centrado y en azul
¿Por qué usar Markdown?
Aunque permite insertar:
$Y = \beta_1 X + \epsilon$
\(Y = \beta_1 X + \epsilon\)
¿Por qué usar Markdown?
Es muy rápido:
¿Por qué usar Markdown?
Es interoperable
Pero…
(what you see is what you get)
(Aunque hay editores, e.g.: StackEdit)
Pero…
- Requiere herramientas específicas de colaboración
Rmarkdown
¿Qué es Rmarkdown?
¿Qué es Rmarkdown?
Extensión de markdown
Consiste en:
¿Qué es Rmarkdown?
Cálculos
PERCENT <- n_control / n_total * 100
El grupo control representó el `r PERCENT`% del total.
El grupo control representó el 31.5% del total.
¿Qué es Rmarkdown?
Gráficos
ecs_bl %>% ggplot(aes(x = q1011_age)) + geom_histogram(fill = "lightblue")
¿Qué es Rmarkdown?
Tablas
ecs_bl %>% as_factor() %>% count(q0001_rc, proxy) %>% kable()
| Finland |
Yes |
42 |
| Finland |
No |
1934 |
| Poland |
Yes |
131 |
| Poland |
No |
3940 |
| Spain |
Yes |
170 |
| Spain |
No |
4583 |
¿Qué es Rmarkdown?
Extensión de markdown
Consiste en:
Encabezado (YAML):
---
title: "Habits"
output:
pdf_document:
toc: true
number_sections: true
---
(Ejemplo de R Markdown: The Definitive Guide)
Ejemplo
- Documento (múltiples formatos)
¿Merece la pena aprender?
- Nociones de HTML y \(\LaTeX\)
¿Merece la pena aprender?
- Ahorro de esfuerzos
- Desarrollo profesional
- Ciencia abierta: Reproducibilidad + Replicabilidad
Flujo de trabajo
- Automatización con Rmarkdown:
Conclusión
Rmarkdown…
- facilita la reproducibilidad
“Retos”
Nivel 1: Tutorial markdown
“Retos”
Nivel 2: Instalar entorno Rstudio
install.packages("tinytex")
library(tinytex)
install_tinytex()
“Retos”
Nivel 3: Replicar guía de instalación de OneDrive
install.packages("revealjs")
FIN
Eso ha sido todo
¡Muchas gracias!
